home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmview+.z / pmview+
Encoding:
Text File  |  2002-10-03  |  32.3 KB  |  529 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmvvvviiiieeeewwww++++ - performance metrics 3D visualization back-end
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmvvvviiiieeeewwww++++ [----CCCCzzzz] [----AAAA _a_l_i_g_n] [----aaaa _a_r_c_h_i_v_e[,,,,_a_r_c_h_i_v_e,,,,...]]  [----cccc _c_o_n_f_i_g_f_i_l_e] [----hhhh
  13.      _h_o_s_t] [----nnnn _p_m_n_s_f_i_l_e] [----OOOO _o_r_i_g_i_n] [----pppp _p_o_r_t] [----RRRR _l_o_g_c_o_n_f_i_g] [----rrrr _a_d_d_c_o_n_f_i_g]
  14.      [----SSSS _s_t_a_r_t_t_i_m_e] [----tttt _i_n_t_e_r_v_a_l] [----TTTT _e_n_d_t_i_m_e] [----xxxx _v_e_r_s_i_o_n] [----ZZZZ _t_i_m_e_z_o_n_e]
  15.      [----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y] [----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y] [----nnnnaaaammmmeeee _n_a_m_e] [----ttttiiiittttlllleeee _t_i_t_l_e] [----xxxxrrrrmmmm
  16.      """"_r_e_s_o_u_r_c_e_N_a_m_e:::: _v_a_l_u_e"""" ...]  [_o_t_h_e_r _X_1_1-_a_r_g_s]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      ppppmmmmvvvviiiieeeewwww++++ is an extension of ppppmmmmvvvviiiieeeewwww((((1111)))) - a generalized 3D performance
  20.      metrics visualization tool for the Performance Co-Pilot (PPPPCCCCPPPP(1)).  It is
  21.      compatible with ppppmmmmvvvviiiieeeewwww (with an exception that version 1 configuration
  22.      files are not supported) while adding support for ``plumbing'', i.e.
  23.      interconnects between the bases of ppppmmmmvvvviiiieeeewwww's grids. Interconnects could be
  24.      represented either as unanimated lllliiiinnnnkkkkssss, or animated ppppiiiippppeeeessss with associated
  25.      metrics.
  26.  
  27.      ppppmmmmvvvviiiieeeewwww++++ is used by oooovvvviiiieeeewwww((((1111)))) to display information about Origin 3000
  28.      servers.  ppppmmmmvvvviiiieeeewwww++++ is the base utility behind performance metrics
  29.      visualization tools such as ddddkkkkvvvviiiissss(1), mmmmppppvvvviiiissss(1), oooossssvvvviiiissss(1), nnnnffffssssvvvviiiissss(1),
  30.      nnnnooooddddeeeevvvviiiissss(1), rrrroooouuuutttteeeerrrrvvvviiiissss(1), xxxxbbbboooowwwwvvvviiiissss(1) and xxxxllllvvvv____vvvviiiissss(1).  It is also used by
  31.      a range of related tools that are specific to optional Performance Domain
  32.      Agents (PMDA) and/or PCP add-on products.  ppppmmmmvvvviiiieeeewwww++++ may also be used to
  33.      construct customized 3D performance displays.
  34.  
  35.      ppppmmmmvvvviiiieeeewwww++++ displays performance metrics as colored blocks and cylinders
  36.      arranged on monochrome base planes. Each object may represent a single
  37.      performance metric, or a stack of several performance metrics.  Since the
  38.      objects are modulated by the value of the metric they represent, only
  39.      numerical metrics may be visualized.  Objects representing a single
  40.      metric may be modulated in terms of height, color, or height and color.
  41.      Objects in a stack may only be height modulated, but the stack can be
  42.      normalized to the maximum height.  Labels may be added to the scene to
  43.      help identify groups of metrics.
  44.  
  45.      A configuration file (as specified by the ----cccc option, or read from
  46.      standard input) is used to specify the position, color, maximum value and
  47.      labels of metrics and metric instances in the scene.  The maximum value
  48.      acts as a normalization factor and is used to scale the object height
  49.      and/or color in proportion to the metric values.  Metric values which
  50.      exceed the associated maximum value are displayed as solid white objects.
  51.      If a metric is unavailable, the object will have minimum height and will
  52.      be colored grey.
  53.  
  54.      Normally, the tool operates in ``live'' mode where performance metrics
  55.      are fetched in real-time.  The user can view metrics from any host
  56.      running ppppmmmmccccdddd(1).  ppppmmmmvvvviiiieeeewwww++++ can also replay archives of performance metrics
  57.      (see ppppmmmmllllooooggggggggeeeerrrr(1)) and allow the user to interactively control the current
  58.      replay time and rate using the VCR paradigm.  This is particularly useful
  59.      for retrospective comparisons and for post-mortem analysis of performance
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  71.  
  72.  
  73.  
  74.      problems where a remote system is not accessible or a performance analyst
  75.      is not available on-site.
  76.  
  77.      All metrics in the Performance Metrics Name Space (PMNS) with numeric
  78.      value semantics from any number of hosts or archives may be visualized.
  79.      ppppmmmmvvvviiiieeeewwww++++ examines the semantics of the metrics and where sensible,
  80.      converts metric values to a rate before scaling.
  81.  
  82. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  83.      The ----SSSS, ----TTTT, ----OOOO and ----AAAA options may be used to define a time window to
  84.      restrict the samples retrieved, set an initial origin within the time
  85.      window, or specify a ``natural'' alignment of the sample times; refer to
  86.      PPPPCCCCPPPPIIIInnnnttttrrrroooo((((1111)))) for a complete description of these options.
  87.  
  88.      The other available options are:
  89.  
  90.      ----aaaa _a_r_c_h_i_v_e[,,,,_a_r_c_h_i_v_e,,,,...]]
  91.           Specify an _a_r_c_h_i_v_e from which metrics can be obtained for a
  92.           particular host. _a_r_c_h_i_v_e is the basename of an archive, previously
  93.           created by ppppmmmmllllooooggggggggeeeerrrr(1).  Multiple archives (separated by commas or
  94.           in different ----aaaa options) from different hosts may be given, but an
  95.           error will occur if there is more than one archive from the same
  96.           host. Any metrics that are not associated with a specific host or
  97.           archive in the configuration file will use the first archive as
  98.           their source.
  99.  
  100.      ----CCCC   Parse the configuration file and exit before displaying the ppppmmmmvvvviiiieeeewwww++++
  101.           window.  Any errors in the configuration file are displayed.
  102.  
  103.      ----cccc _c_o_n_f_i_g_f_i_l_e
  104.           Load the configuration from _c_o_n_f_i_g_f_i_l_e rather than standard input.
  105.  
  106.      ----hhhh _h_o_s_t
  107.           Fetch performance metrics from ppppmmmmccccdddd(1) on _h_o_s_t, rather than the
  108.           default localhost.  Implies that ppppmmmmvvvviiiieeeewwww++++ will run in live mode, so
  109.           no archives can be specified on the command line or in the
  110.           configuration file.  Only one ----hhhh option may be given.
  111.  
  112.      ----nnnn _p_m_n_s_f_i_l_e
  113.           Normally ppppmmmmvvvviiiieeeewwww++++ operates on the distributed Performance Metrics
  114.           Name Space (PMNS), however if the ----nnnn option is specified an
  115.           alternative local PMNS is loaded from the file _p_m_n_s_f_i_l_e.
  116.  
  117.      ----pppp _p_o_r_t
  118.           Connect to the time controls (see ppppmmmmttttiiiimmmmeeee(1)) on this ppppoooorrrrtttt.  Used
  119.           when a tool launches another tool so that they can connect to the
  120.           same time controls.
  121.  
  122.      ----RRRR _l_o_g_c_o_n_f_i_g
  123.           Use _l_o_g_c_o_n_f_i_g as the ppppmmmmllllooooggggggggeeeerrrr(1) config when recording.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  137.  
  138.  
  139.  
  140.      ----rrrr _a_d_d_c_o_n_f_i_g
  141.           Append _a_d_d_c_o_n_f_i_g onto the ppppmmmmllllooooggggggggeeeerrrr(1) config generated by ppppmmmmvvvviiiieeeewwww++++
  142.           when recording.
  143.  
  144.      ----tttt _i_n_t_e_r_v_a_l
  145.           The update _i_n_t_e_r_v_a_l used to fetch metrics from the live or archive
  146.           sources.  The _i_n_t_e_r_v_a_l argument follows the syntax described in
  147.           PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), and in the simplest form may be an unsigned integer
  148.           (the implied units in this case are seconds).  The default is 2.0
  149.           seconds.
  150.  
  151.      ----xxxx _v_e_r_s_i_o_n
  152.           Use the specified _v_e_r_s_i_o_n of the ppppmmmmllllaaaauuuunnnncccchhhh(5) specification.  The
  153.           versions currently supported are ``1.0'' and the default version
  154.           ``2.0''.
  155.  
  156.      ----ZZZZ _t_i_m_e_z_o_n_e
  157.           By default, ppppmmmmvvvviiiieeeewwww++++ reports the time of day according to the local
  158.           timezone on the system where ppppmmmmvvvviiiieeeewwww++++ is run.  The ----ZZZZ option changes
  159.           the default timezone to _t_i_m_e_z_o_n_e which should be in the format of
  160.           the environment variable TTTTZZZZ as described in eeeennnnvvvviiiirrrroooonnnn(5).
  161.  
  162.      ----zzzz   Change the reporting timezone to the local timezone at the host that
  163.           is the source of the performance metrics, as identified via either
  164.           the ----hhhh option, or the first ----aaaa option.
  165.  
  166.      ----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y
  167.      ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  168.      ----nnnnaaaammmmeeee _n_a_m_e
  169.      ----ttttiiiittttlllleeee _t_i_t_l_e
  170.      ----xxxxrrrrmmmm """"_r_e_s_o_u_r_c_e_N_a_m_e: _v_a_l_u_e""""
  171.  
  172.           Most standard XXXX(1) command line arguments may be used.
  173.  
  174. WWWWIIIINNNNDDDDOOOOWWWW
  175.      The ppppmmmmvvvviiiieeeewwww++++ window is comprised of a menu bar, time and scale controls,
  176.      metric and time values, and an ``examiner'' viewer (see iiiivvvvvvvviiiieeeewwww(1)), which
  177.      displays the 3D scene.
  178.  
  179. EEEEXXXXAAAAMMMMIIIINNNNEEEERRRR VVVVIIIIEEEEWWWWEEEERRRR
  180.      The left, right and bottom edges of the examiner viewer contain a variety
  181.      of thumb wheels and buttons that can be used to adjust the visualization
  182.      of the 3D scene.  The _R_o_t_x and _R_o_t_y thumb wheels allow the user to rotate
  183.      the scene about the x and y axes, respectively.  The _d_o_l_l_y thumb wheel
  184.      moves the virtual camera closer and further from the scene allowing the
  185.      user to examine specific parts in detail or view the entire scene.  On
  186.      the right edge of the viewer are eight buttons which affect the way the
  187.      user can interact with the scene.
  188.  
  189.      _P_o_i_n_t_e_r
  190.          Changes the cursor to a pointer which allows blocks to be selected in
  191.          the scene.  See the Metric Selection section below.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  203.  
  204.  
  205.  
  206.      _H_a_n_d
  207.          Changes the cursor to a hand which allows the scene to be rotated,
  208.          translated and dollied using a combination of mouse buttons.  The
  209.          left mouse button can be used to rotate the scene in the direction of
  210.          the mouse.  Releasing the left mouse button before the mouse has
  211.          stopped moving will cause the scene to continue to rotate, which can
  212.          be stopped by pressing the left mouse button again.  The middle mouse
  213.          button will ``pan'' the scene, and both mouse buttons act as a dolly
  214.          for the virtual camera.
  215.  
  216.      _Q_u_e_s_t_i_o_n _M_a_r_k
  217.          Displays the SGI Help information for the examiner viewer.
  218.  
  219.      _H_o_m_e
  220.          Changes the scene back to its original position, unless the home
  221.          position has been changed by the home pointer button.
  222.  
  223.      _H_o_m_e _P_o_i_n_t_e_r
  224.          Changes the home position of the scene to be the scene currently in
  225.          view.
  226.  
  227.      _E_y_e Resizes the scene so that it completely fits into the 3D viewing
  228.          area.
  229.  
  230.      _C_r_o_s_s-_h_a_i_r_s
  231.          Moves the object under the cursor to the center of the viewing area,
  232.          if the hand cursor has been selected.  Pressing the ``s'' key while
  233.          the cursor is over an object has the same effect.
  234.  
  235.      _P_e_r_s_p_e_c_t_i_v_e _B_o_x
  236.          Switches the display between perspective and orthogonal projections.
  237.  
  238.      Pressing the right mouse button within the scene window will bring up a
  239.      menu of options which affect how the 3D scene is drawn.  The options
  240.      include drawing the blocks as wire frames, and turning on stereo viewing.
  241.  
  242. MMMMEEEETTTTRRRRIIIICCCC SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
  243.      When the pointer cursor is active, more information about the 3D scene
  244.      can be obtained.  Text describing the metric represented by the block
  245.      under the cursor will be displayed in the top text box of the ppppmmmmvvvviiiieeeewwww++++
  246.      window.  The text contains the source and name of the metric, current
  247.      value and units, and the percentage of the expected maximum (or
  248.      normalization) value.  The text box is updated whenever the scene is
  249.      updated with the latest metric values or when the cursor is moved over
  250.      another block in the scene.  Moving the cursor over a base plane block,
  251.      text or the surrounding space will clear the text box.
  252.  
  253.      Clicking the left mouse button on a block will bind the text box on that
  254.      metric instance so that the metric can be monitored while performing
  255.      other actions with the mouse.  The block will be highlighted with a red
  256.      wire frame.  Clicking the left mouse button on text or the space
  257.      surrounding the scene will unselect the object, causing the text box to
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  269.  
  270.  
  271.  
  272.      revert to the original behavior of showing the metric underneath the
  273.      cursor.
  274.  
  275.      Selecting a base plane instead of a modulated block will cause all the
  276.      blocks on that base plane to be selected.  When more than one object is
  277.      selected, the text box behaves as if nothing is selected, so the metric
  278.      displayed is the metric currently under the cursor.  Multiple selections
  279.      are also possible by pressing the SHIFT key while selecting an object
  280.      with the left mouse button.
  281.  
  282. MMMMEEEENNNNUUUUSSSS
  283.      There are four menus in ppppmmmmvvvviiiieeeewwww++++'s user interface which allow scenes to be
  284.      recorded, saved and printed (FFFFiiiilllleeee), access to the time controls
  285.      (OOOOppppttttiiiioooonnnnssss), launching other tools (LLLLaaaauuuunnnncccchhhh) and online help (HHHHeeeellllpppp).
  286.  
  287.      FFFFiiiilllleeee////RRRReeeeccccoooorrrrdddd
  288.          When in ``live'' mode, this option will launch ppppmmmmllllooooggggggggeeeerrrr(1) processes
  289.          to record the current scene into an archive folio (see ppppmmmmaaaaffffmmmm((((1111)))))))) so
  290.          that it may be replayed at a later time.  This option is not
  291.          available in ``replay'' mode.
  292.  
  293.          When FFFFiiiilllleeee////RRRReeeeccccoooorrrrdddd is selected, a file chooser dialog will prompt for
  294.          the name of the new archive folio.  If the directory to the folio
  295.          does not exist, ppppmmmmvvvviiiieeeewwww++++ will attempt to create it.  It is usually
  296.          convenient to keep each folio within its own directory as there will
  297.          be several other files associated with the folio, including the
  298.          generated archives.
  299.  
  300.          Once a valid folio has been created, ppppmmmmvvvviiiieeeewwww++++ will launch a
  301.          ppppmmmmllllooooggggggggeeeerrrr(1) process for each host to collect the metrics required
  302.          from that host in the current scene.  The current selections do not
  303.          affect the set of metrics that are recorded.
  304.  
  305.          While recording is in progress, a red dot will appear in the time
  306.          controls button in the top left-hand corner of the ppppmmmmvvvviiiieeeewwww++++ window.
  307.          The FFFFiiiilllleeee////RRRReeeeccccoooorrrrdddd option will also change to FFFFiiiilllleeee////SSSSttttoooopppp RRRReeeeccccoooorrrrddddiiiinnnngggg as
  308.          only one recording session is possible at any one time.  Selecting
  309.          blocks or launching other tools will have no affect on the recording
  310.          session.
  311.  
  312.          The record session may be terminated by selecting FFFFiiiilllleeee////SSSSttttoooopppp
  313.          RRRReeeeccccoooorrrrddddiiiinnnngggg.  This will display dialogs for each ppppmmmmllllooooggggggggeeeerrrr(1) instance
  314.          describing the size and location of the archive files before
  315.          terminating each process.  When all ppppmmmmllllooooggggggggeeeerrrr(1) processes have been
  316.          terminated, the red dot is removed from the time controls button, and
  317.          the menu reverts back to FFFFiiiilllleeee////RRRReeeeccccoooorrrrdddd to allow another recording
  318.          session to take place.
  319.  
  320.          If the application exists while recording, a dialog will appear
  321.          allowing you to terminate each ppppmmmmllllooooggggggggeeeerrrr(1) process, or leave it
  322.          running unattached.
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  335.  
  336.  
  337.  
  338.          An archive folio may be replayed using the command:  ``ppppmmmmaaaaffffmmmm _f_o_l_i_o
  339.          rrrreeeeppppllllaaaayyyy''.  See ppppmmmmaaaaffffmmmm(1) for more details.
  340.  
  341.          It is not uncommon for a front-end script which generates a ppppmmmmvvvviiiieeeewwww++++
  342.          scene to use metrics that are not contained in the scene.  For
  343.          example, oooossssvvvviiiissss(1) uses several _h_i_n_v metrics to determine the size and
  344.          layout of some objects.  As these metrics are also needed when
  345.          replaying the generated archive with the front-end script, a complete
  346.          ppppmmmmllllooooggggggggeeeerrrr(1) config can be specified (----RRRR) that overrides the ppppmmmmvvvviiiieeeewwww++++
  347.          generated config, or an additional config can be appended (----rrrr) to the
  348.          ppppmmmmvvvviiiieeeewwww++++ generated config.
  349.  
  350.      FFFFiiiilllleeee////SSSSaaaavvvveeee
  351.          Saves the current scene to a human-readable Open Inventor file (see
  352.          iiiinnnnvvvveeeennnnttttoooorrrr(1)).  A file dialog will prompt for the location of the
  353.          file.  The default file extension is ``.iv'' which is recognized by
  354.          iiiivvvvvvvviiiieeeewwww(1) and some Web browsers.
  355.  
  356.      FFFFiiiilllleeee////PPPPrrrriiiinnnntttt
  357.          Outputs the current scene to a printer.  A print dialog will be
  358.          displayed allowing a specific printer to be selected.
  359.  
  360.      FFFFiiiilllleeee////QQQQuuuuiiiitttt
  361.          ppppmmmmvvvviiiieeeewwww++++ immediately exits.  If recording was active, dialogs will be
  362.          displayed for each ppppmmmmllllooooggggggggeeeerrrr(1) process so that they may be
  363.          terminated.
  364.  
  365.      OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll
  366.          Displays the time controls (see ppppmmmmttttiiiimmmmeeee(1)) that are driving this
  367.          instance of ppppmmmmvvvviiiieeeewwww++++.  The time controls may be shared by other tools,
  368.          including ppppmmmmcccchhhhaaaarrrrtttt(1), that have been launched by other instances of
  369.          ppppmmmmvvvviiiieeeewwww++++ and oooovvvviiiieeeewwww(1).  Therefore, this menu item may appear to have
  370.          no affect if the time controls are already visible.
  371.  
  372.      OOOOppppttttiiiioooonnnnssss////NNNNeeeewwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll
  373.          Disconnect with the current time controls (which may be shared by
  374.          other tools, see ppppmmmmttttiiiimmmmeeee(1)) and use a new time control that is not
  375.          connected to any other tools.  The new time control will be
  376.          immediately displayed.
  377.  
  378.      LLLLaaaauuuunnnncccchhhh
  379.          The launch menu is generated from a menu specification file (see
  380.          ppppmmmmllllaaaauuuunnnncccchhhh(5)).  The menu contains tools that may be launched based on
  381.          the sources and names of the selected metrics in the scene.  For
  382.          example, if the selected metrics are from three different hosts, then
  383.          three copies of a tool may be launched, one for each host.  The
  384.          behavior of a launch depends on the selected metrics and the tools
  385.          being launched.
  386.  
  387.          On selection of a LLLLaaaauuuunnnncccchhhh menu item ppppmmmmvvvviiiieeeewwww++++ generates state
  388.          information in the ppppmmmmllllaaaauuuunnnncccchhhh(5) metrics specification format.  This
  389.          provides a description of the selected metrics (or if there are no
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  401.  
  402.  
  403.  
  404.          selections, all the metrics) in the scene without any geometry
  405.          information.
  406.  
  407.          Tools which can monitor multiple hosts and user specified metrics may
  408.          be launched only once for those metrics (eg ppppmmmmdddduuuummmmpppptttteeeexxxxtttt(1)).  Other
  409.          tools which have a fixed view for one host (eg mmmmppppvvvviiiissss(1)), may be
  410.          launched multiple times, once for each host in the selected metric
  411.          list.  If the launched tools have time controls, they will share the
  412.          time controls with the launching ppppmmmmvvvviiiieeeewwww++++.
  413.  
  414.          The set of launched tools is configurable, and may include IRIX and
  415.          user applications.  See ppppmmmmllllaaaauuuunnnncccchhhh(5) for more details.
  416.  
  417.      HHHHeeeellllpppp////............
  418.          If _p_c_p._b_o_o_k_s._h_e_l_p has been installed, then the iiiinnnnssssiiiigggghhhhtttt(1) books for
  419.          ppppmmmmvvvviiiieeeewwww++++ are displayed.
  420.  
  421. TTTTIIIIMMMMEEEE CCCCOOOONNNNTTTTRRRROOOOLLLLSSSS
  422.      In addition to the menu options for time controls, the current direction
  423.      of the time controls (see ppppmmmmttttiiiimmmmeeee(1)) is shown in a button in the top-left
  424.      corner of the ppppmmmmvvvviiiieeeewwww++++ window.  Pressing this button will display the time
  425.      control and is identical in behavior to OOOOppppttttiiiioooonnnnssss////SSSShhhhoooowwww TTTTiiiimmmmeeee CCCCoooonnnnttttrrrroooollll.
  426.  
  427. SSSSCCCCAAAALLLLEEEE CCCCOOOONNNNTTTTRRRROOOOLLLLSSSS
  428.      Above the examiner window is a thumb wheel and an editable text box which
  429.      allow the user to apply a multiplier to all values represented in the
  430.      scene. Spinning the wheel to the right and/or increasing the text value
  431.      for the scale will increase the height of the bars.  Spinning the wheel
  432.      to the left and/or lowering the text value will decrease the height of
  433.      the bars.  The button to the right of the thumb wheel will reset the
  434.      scale so that the bars appear at the original height for their current
  435.      value.
  436.  
  437. TTTTIIIIMMMMEEEE IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  438.      Beside the scale controls is another text box which displays the time of
  439.      the fetched metrics.  The time will change with the time controller (see
  440.      ppppmmmmttttiiiimmmmeeee(1)).
  441.  
  442. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  443.      The default face of the 3D font in the ppppmmmmvvvviiiieeeewwww++++ window can be altered via
  444.      _P_M_V_I_E_W__F_O_N_T environment variable which can be set to the base name of a
  445.      Type1 font file in the default Inventor fonts directory.
  446.  
  447. FFFFIIIILLLLEEEESSSS
  448.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ppppmmmmnnnnssss////****
  449.                default PMNS specification files
  450.  
  451.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllaaaauuuunnnncccchhhh////ppppmmmmllllaaaauuuunnnncccchhhhrrrrcccc
  452.                menu specification file - provides a mapping between menu item
  453.                and launched program
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))                                                          PPPPMMMMVVVVIIIIEEEEWWWW++++((((1111))))
  467.  
  468.  
  469.  
  470.      $$$$HHHHOOOOMMMMEEEE////....ppppccccpppp////ppppmmmmllllaaaauuuunnnncccchhhh////ppppmmmmllllaaaauuuunnnncccchhhhrrrrcccc
  471.                individual users menu specification
  472.  
  473.      ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////PPPPmmmmVVVViiiieeeewwww++++
  474.                application resources
  475.  
  476.      ////uuuussssrrrr////lllliiiibbbb////iiiimmmmaaaaggggeeeessss////PPPPmmmmVVVViiiieeeewwww++++....iiiiccccoooonnnn
  477.                icon for ppppmmmmvvvviiiieeeewwww++++
  478.  
  479.      $$$$PPPPCCCCPPPP____SSSSHHHHAAAARRRREEEE____DDDDIIIIRRRR////lllliiiibbbb////ppppmmmmvvvviiiieeeewwww----aaaarrrrggggssss
  480.                shell procedures for parsing ppppmmmmvvvviiiieeeewwww++++ command line options in
  481.                front end scripts
  482.  
  483.      ////uuuussssrrrr////lllliiiibbbb////DDDDPPPPSSSS////oooouuuuttttlllliiiinnnneeee////bbbbaaaasssseeee////
  484.                directory where Inventor normally looks for the outlines of
  485.                Type1 fonts.
  486.  
  487. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  488.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  489.      file and directory names used by PCP.  On each installation, the file
  490.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  491.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  492.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  493.  
  494. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  495.      ddddkkkkvvvviiiissss(1), iiiinnnnssssiiiigggghhhhtttt(1), iiiinnnnvvvveeeennnnttttoooorrrr(1), iiiivvvvvvvviiiieeeewwww(1), mmmmppppvvvviiiissss(1), nnnnffffssssvvvviiiissss(1),
  496.      nnnnooooddddeeeevvvviiiissss(1), oooossssvvvviiiissss(1), oooovvvviiiieeeewwww(1), ppppccccpppp(1), PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmaaaaffffmmmm(1), ppppmmmmccccdddd(1),
  497.      ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppptttteeeexxxxtttt(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmttttiiiimmmmeeee(1), ppppmmmmvvvviiiieeeewwww(1),
  498.      rrrroooouuuutttteeeerrrrvvvviiiissss(1), XXXX(1), xxxxbbbboooowwwwvvvviiiissss(1), xxxxccccoooonnnnffffiiiirrrrmmmm(1), xxxxllllvvvv____vvvviiiissss(1), ppppccccpppp....ccccoooonnnnffff(4),
  499.      ppppmmmmvvvviiiieeeewwww++++(4), eeeennnnvvvviiiirrrroooonnnn(5) and ppppmmmmllllaaaauuuunnnncccchhhh(5).
  500.  
  501.      Relevant information is also available from the on-line PCP Tutorial.
  502.      Provided the ppppccccpppp....mmmmaaaannnn....ttttuuuuttttoooorrrriiiiaaaallll subsystem from the PCP images has been
  503.      installed, access the URL ffffiiiilllleeee::::$$$$PPPPCCCCPPPP____DDDDOOOOCCCC____DDDDIIIIRRRR////TTTTuuuuttttoooorrrriiiiaaaallll////ppppmmmmvvvviiiieeeewwww....hhhhttttmmmmllll from
  504.      your web browser.
  505.  
  506.  
  507. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  508.      Are intended to be self-explanatory.  The environment variable PPPPCCCCPPPP____SSSSTTTTDDDDEEEERRRRRRRR
  509.      can be set to force most startup warnings and errors to be sent to the
  510.      standard error stream rather than posted in a dialog.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.